Command Reference for DSP-12 (Digital Signal Processor)
═COMMAND══════ARG════DEFAULT═══════════DESCRIPTION═══
*
* This file was created for use with the paKet (c) 1989 program only
*                       by Carl, VK2JJM.
*
* The above two lines must remain in this file as is. They are used
* by the program for the headings on the display window.
* The first describes the type of TNC this file is set up for and
* is displayed on the bottom of the TNC help window.
* The second is the headings for the TNC help window and this line
* should line up with the "header" data in this file.
*
* Each help item starts with its "header" which is identified by
* the "@" in the first column. This is then followed by a variable
* number of lines of detailed help for that item. The maximum number
* of lines is determined by the size of the help window - this detailed
* information does not scroll in the help window, and any lines that
* do not fit will be ignored.
*
* Any line in this file beginnin or g with an "*" is treated as a comment
* and is ignored by the paKet program.
*
*UPPERCASE CHARACTERS are minimum that will be correctly parsed by the TNC.
******************************************************************************
@3rdparty     ON|OFF    ON      Allow/Disallow messages to other than MYCALL.
Parameters:
     ON  - Allow messages to be left for other callsigns.
     OFF - Allow messages for Mailbox call only.

A limited form of bulletin board system implemented in release GCE 1.92, not
permitted in some countries. It is used in conjunction with the Mailbox,
which must be ON for this to be implemented.
******************************************************************************
@8bitconv     ON|OFF    OFF     Pass or strip high bit in CONVerse mode.
Parameters:
     ON  - High order bit is not stripped in Converse Mode.
     OFF - High order bit is stripped in Converse Mode.

This enables transmission of 8 bit data while in Converse mode.
If 8BITCONV is OFF, the high order bit (bit 7) of the characters from
paKet to the DSP-12, is removed before the characters are transmitted in
a packet. ASCII characters only require 7 bits (0-6) and the final
bit is sometimes used as a parity bit. Setting bit 7 in text
characters transmitted sometimes causes problems at the receiving
end. Bit 7 is always removed in COMMAND mode.

If you want to transmit 8 bit data, but don't want all the features of
transparent mode, you should set 8BITCONV ON.

This command is stored seperately for each DSP-12 mode.
******************************************************************************
@ACkpriority  ON|OFF    OFF     Set Priority for <Ack> Frames.
Parameters:
     ON  - Data acknowledgement frames (RR or RNR) get high priority
     OFF - Data acknowledgement frames get normal priority

When ON, data acknowledgement frames (RR and RNR) have the same high priority
as a digipeated frame.  The Ack frame is sent as soon as the channel is
clear.  The SLOTMASK and DEADtime parameters are ignored.  When OFF, the Ack
frames have the same priority as normal frames.
******************************************************************************
@ACKtime      0-180     10      RR or RNR Acknowledgement time (n * 10ms)
Parameters:
     n = 0 to 180, in 10ms increments.

In units of 10ms, this parameter specifies how long it takes to send an RR or
RNR acknowledgement of a received I-frame at the current data rate.
******************************************************************************
@AXDelay      0-180     0       Extra keyup delay (n * 10ms).
Parameters:
     n = 0 to 180, the voice repeater keyup delay in 10ms increments.

This value specifies the time a DSP-12 is to wait, in addition to the
normal TXDELAY, after keying the transmitter before data is sent.
Use of voice repeaters for Packet transmissions is neither desirable
nor necessary when suitable Digipeaters are available.

This command acts in conjunction with AXHANG.

The DSP-12 has this command implemented with 10ms increments.
******************************************************************************
@AXhang       0-20      0       Voice Rptr hang time (n * 10ms).
Parameters:
     n - 0 to 20 specifies the voice repeater hang time in 10ms
         increments.


This allows for more efficient channel usage if the repeater has a longer
hang or tail than 10ms.

If the packet controller has heard a packet sent within the hang period,
it will not add the extra delay of AXDELAY to the keyup time.

Use of voice repeaters for Packet transmissions is neither desirable
nor necessary when suitable Digipeaters are available.
******************************************************************************
@BBSmsgs      ON|OFF    OFF     Sets message format.
Parameters:
    ON  - Omits "Connect Request: xxxx" and puts other messages on new line.
    OFF - Normal operation.

Primarily useful for host mode operation of W0RLI type BBS's that
require link status messages to begin in the first output column.

The omission of the connect request message is to prevent corruption of
messages when BBS is forwarding.
******************************************************************************
@BCAST        ON|OFF    OFF     Used for Commercial Data Transmission.
Parameters:
    ON  - Enables Commercial Data Transmissions.  NOT for normal Amateur use.
    OFF - Normal operation.

This feature is designed for commercial data transmission applications and
should NOT be used in normal Amateur use.  Setting this parameter ON has the
following effects:
    a) At entry to the operating mode the terminal interface is automatically
       placed into CONVERSE or TRANSPARENT mode (per the setting of CONMODE)
       and BTEXT is cleared.

    b) Data frames generated by received terminal data are not sent, but are
       copied into the BTEXT save area.  Data received by the DSP-12 during
       mode initialization is ignored.  The data length is forcibly limited
       to the maximum BTEXT length.

    c) The operation of the BEACON command is modified such that:
        1) The sending interval is changed to units of 100ms.
        2) The beacon destination is changed from the standard of BEACON to
           the Unprotocol address.
        3) Beacon data frames starting with an ASCII carrage return ($0D) are
           not sent.

    d) The operation of the monitored-packets display is modified so that:
        1) The frame's address information is not displayed.
        2) Dataframes (I and UI) containing a data field that duplicates the
           previously displayed field are ignored.

    e) Connect requests are Ignored.

    f)  Operator initiated connect commands will be rejected.

In typical applications, set BCAST ON, BEACON E 5 and UNprotocol address as
required.  Data sent to the sending DSP-12 will be repeated until new data is
received.  This data received by a DSP-12 in this mode will be sent to the
terminal interface.  Duplicated data will be ignored.
******************************************************************************
@BEacon E/A   0-250     E 0     Send beacon EVERY/AFTER (n * 10 sec).
Parameters:
    EVERY n - Sends beacon text every "n * 10" seconds.
    AFTER n - Sends beacon text once after "n * 10" seconds after last packet.

          'n'- 0 to 250. If n=0, Beacons are disabled.

BTEXT beacons are sent addressed to "BEACON" via the addresses and path
specified in "UNPROTO" command. If BTEXT is blank no beacons are sent.

The AFTER command can be used to send messages or announcements only when
packet stations are on the air and active.
******************************************************************************
@Btext        text      blank   Text  sent as a beacon (0-120 char).
Parameters:
     text - Any normal text message of up to 120 characters and spaces.

BTEXT defines the text sent by the BEACON and is addressed to UNPROTO.

Multiple line messages can be sent by including the <PASS> character and
<CR> character in the text at the end of each line. More than 120
characters causes an error message and the command will be ignored.


See also the BEACON command.
******************************************************************************
@BUdlist      ON|OFF    OFF     Treat LCALLS as only stations to monitor.
Parameters:
     ON  - Ignore frames from stations not in the LCALLS list.
     OFF - Ignore frames from stations in the LCALLS list.

You must set MONITOR ON also. To have MON ON without this being affected
LCALLS must be set to "BLANK".
******************************************************************************
@CBell        ON|OFF    OFF     Enable/Disable connect bell.
Parameters:
     ON  - A bell character will be sent to paKet with a connect message.
     OFF - No bell character is included with connect message.

This is mainly used to attract attention to a connect from another
station if you are not in the immediate vicinity. A bell character will
still be issued even if MFILTER is set to filter out bell characters.
******************************************************************************
@CHeck        0-250     30      Connection timer (n * 10 sec).
Parameters:
     n - 0 to 250 specifies the check time in 10 second intervals.
         0 disables this feature.

After the elapsed time with no packets your DSP-12 will take action to
avoid remaining in the "connected" state indefinitely.

The DSP-12 will initiate a check to see if the link is still good. If no
acknowledgment is received after all retries a disconnect sequence will be
initiated.

******************************************************************************
@CMdtime      0-250     1       Sets transparent mode timeout.
Parameters:
      'n' - 0 to 250 specifies the timeout value in 1 second intervals
            while in Transparent mode.

To exit Transparent mode, wait for 'n' seconds, then enter three COMMAND
characters (default <Ctrl-C>) less than 'n' seconds apart.

So, for the default of CMDTIME 1, wait for one second then type three
<Ctrl-C>s within one second to exit Transparent Mode.

While running paKet, please leave CMDTIME at its default setting.
******************************************************************************
@CMSg         ON|OFF    OFF     Enable/Disable connect message.
Parameters:
     ON  - A text message is sent as first packet after connect is made.
     OFF - The text message is not sent.

The text of the message is contained in CTEXT and is sent after a
connection is made to you by another station.

This function might be useful if you leave your system running but are
unavailable to answer the connect request manually.

It is recommended you leave CMSG ON and change the contents of CTEXT
to reflect the state of your system. This is easily accomplished by
specifying an appropriate CTEXT message in both the Begin and End
Auto commands. (via the Configuration Window options).

The DSP-12 does not disable the CTEXT message when the mailbox is on, so it
is necessary to manually turn CMSG OFF each time the mailbox is used.
******************************************************************************
@CMSGDisc     ON|OFF    OFF     Enable/Disable disconn after CMSG sent.
Parameters:
     ON  - DSP-12 will disconnect after ACK received of CTEXT from CMSG
           function.
     OFF - DSP-12 will not disconnect after connect message sent.

Use with care. This should only be used for unattended DSP-12's where no
Mailbox is desired. If set ON the Mailbox function cannot work as the other
station will be forced into a disconnect sequence immediately after the
CMSG is sent.
******************************************************************************
@COMmand 'n'  0-$7F     $03<^C> Set the COMMAND mode entry character.
Parameters:
      'n' - 0 to 127 specifies the ASCII character used to enter Command
            mode.

The COMMAND mode entry character is the character you type to enter
Command mode from Converse mode.

For paKet please leave this set to the default of 3, which is equivalent
to <Ctrl-C>. When using Binary File transfers, paKet needs to enter
Transparent mode and it may send <Ctrl-C>s to return to Command mode on
completion of the file transfer.
******************************************************************************
@CONMode      CONV|TR   CONV    Sets mode on connect.
Parameters:
     CONVERS      - Sets automatic entry to converse mode on connect.
     TRANSPARENT  - Sets automatic entry to transparent mode on connect.

The connection may be the result of a radio connection request or a
keyboard command if NEWMODE is on.

Take care if you are typing when a radio connection request is received!

If the DSP-12 is already in the correct mode when the connection is
made it will not change.
******************************************************************************
@Connect      Call      none    Connect to a station via optional rptrs.
Parameters:
      call1 [Via call2,call3...]

Example:
      C VK7ABC               Attempt a direct connection to VK7ABC
      C VK7ABC VIA VK7RPT    Attempt a connection to VK7ABC via a
                             digipeater (VK7RPT).
      C VK7ABC V VK7RPT,VK3XX-1,VK3ZZZ
                             Attempt a connection to VK7ABC via 3
                             digipeaters.

Type the digipeater fields in the sequence you wish to use to route your
packets.
The brackets are not typed.

An error message is returned and the command is aborted if:
   - no response after RETRY attempts, or
   - the other Station is already connected, or
   - the other Station is attempting a connect, or a disconnect.
******************************************************************************
@CONOk        ON|OFF    ON      Allow connections to your DSP-12.
Parameters:
     ON  - Connect requests from other stations will be accepted.
     OFF - Connect request from other station will be rejected.

The rejected connect request will result in the other station having
"*** yourcall station busy" message displayed on his screen. This is
extensively used by BBS's to control automated access and forwarding of
mail.
******************************************************************************
@CONPerm      ON|OFF    OFF     Select temporary or permanent connection.
Parameters:
     ON  - The current connect on the current stream will not disconnect.
     OFF - Normal operation of connects and disconnects.

This command only takes effect after connect is established. It functions
on a stream by stream basis when multiple connections are allowed.

The connection will be reestablished if RETRY is exceeded.

It is particularly useful when paKet is used as a local area network
server in 'contest' mode.
******************************************************************************
@CONVers      none              Enter CONVERSE mode from CMD PROMPT:
This is an immediate command to enter the converse mode from command mode.

Link connections are not affected and a return to the command mode can be
made by typing in the Command Mode Entry character (default <Ctrl-C>).
******************************************************************************
@CPactime     ON|OFF    OFF     CONVERS mode timed packet dispatch.
Parameters:
     ON  - Packet timeout is used in Converse mode.
     OFF - Packet timeout is not used. In this case the <SENDPAC>
           character (usually a <CR> sends the packet.

If CPACTIME is ON, any characters which have been input will be packetised
and sent after PACTIME has elapsed since the last frame was transmitted.
This allows automatic periodic sending of packets in converse mode,
similar to full break-in CW. This allows continuous typing by both
stations.

It is recommended, however, that paKet's Type Ahead window be used
instead of CPACTIME to allow communication without the delays while
long packets are being typed.
*****************************************************************************
@CR           ON|OFF    ON      Append carriage return to each packet.
Parameters:
    ON  - The CR character is appended to all packets sent in converse mode.
    OFF - This send packet character is stripped from all conv packets sent.

Various formatting modes can be achieved with this, SENDPAC $0D, LFADD
and AUTOLF commands if the other station reports overprinting of lines.

paKet has an automatic word wrap option available at the end of lines in
the Type Ahead window.
******************************************************************************
@CStatus      none              Display status of all streams.

An immediate command to show the link status and whether or not CONPERM is
active on the stream.

******************************************************************************
@CText        text      blank   Connect message text (120 char).
Parameters:
      text - Any combination of characters and spaces (up to a
             maximum of 120 characters).

If CMSG is ON, the CTEXT message is sent as soon as another station
connects to your station.

Multiple line messages may be sent if the pass character (Ctrl/V) and
<CR> is used at end of each line.

To clear the CTEXT buffer without issuing a RESET command use % or & as
the first character.
******************************************************************************
@DAytime      yymmddhhmm        Set or display date and time of RTC.
Parameters:
      'date/time' - This should be the current date and time in the
                    format: "YYMMDDHHMMSS".

All two digit number groups must have leading zero if from 00 - 09. The
hours digits must be in the 24hr format and the year is the last two
digits.

paKet will generate this command for you automatically when the program
starts.

When the date and time are entered correctly, the DSP-12 will echo the new
setting and if no 'date/time' is entered, the current setting is displayed.

The date & time parameter is used in CONSTAMP, MSTAMP and MHEARD if set.
******************************************************************************
@DCDconn      ON|OFF    ON      Enable/Disable DCD output control line.
Parameters:
     ON  - The DSP-12 will switch DCD line on Connects..
     OFF - The DSP-12 will use line as an outbound flow control (CTS).

When ON the DSP-12 will reflect the packet connected status onto the terminal
interface's output control signal.  In this mode the output control signal
will be off when disconnected and on when connected.  When OFF the DSP-12's
output control signal will be used as an outbound flow control signal (CTS).
******************************************************************************
@DEAdtime     0-250     10      Length of Random delay introduced by DSP-12.
Parameters:
      'n' - 0 to 250 specifies the random delay in conjunction with SLOTMASK

In units of 10ms, this parameter in conjunction with the SLOTMASK parameter
specifies the length of the random delay introduced by the DSP-12.  This
random delay starts after loss of DCD from another transmitting station and
before the DSP-12 starts sending.  The delay period is calculated as a
random number between 0 and SLOTMASK multiplied by the DEADTIME period.

This Random delay is created to reduce the likelihood of having 2 nodes
holding sendable data, start sending frames at the same time.
******************************************************************************
@DIGipeat     ON|OFF    ON      Enable/disable digipeating through you.
Parameters:
     ON  - The DSP-12 will allow digipeating through your call.
     OFF - The DSP-12 will not allow digipeating.

Digipeating takes place concurrently with other DSP-12 operations and
doesn't interfere with normal connections you may be having with other
stations.

HID enables automatic identification of your station if acting as a
digipeater.
******************************************************************************
@Disconne     none              Teardown connection path.
Parameters:
      None

This is an immediate command to initiate a disconnect command to the other
station with the resultant display of :-
    *** DISCONNECTED
when successful.

If a disconnect is issued while a connect is being attempted and before
the retries have been completed then the message :-
    *** retry count exceeded
    *** DISCONNECTED
will appear after the DSP-12 ceases to attempt the connect.

Disconnect messages do not appear if in transparent mode.

A new connect from another station is not allowed until the disconnect
process is completed.
******************************************************************************
@DIsplay      (+)               Display all Current Parameters.
Parameters:
        +     - Display all current parameters and their values.
        None  - Each group of commands is displayed with a pause in between.
******************************************************************************
@DWait        0-250     16      Delay for digipeaters (n * 10ms).
Parameters:
     n = 0 - 250 specifying default wait time in 10ms intervals.

DSP-12 will wait the default time after last hearing a data packet on the
frequency before beginning the keyup sequence. This is used to avoid
collisions with digipeated packets because these aren't retried by the
digipeating station, but must be reinserted in the system by the
originating station.

The ROSE or NETROM networking when fully implemented will go a long way to
eliminating this problem.

Recommended settings for different types of operation:-
            Digipeaters          0   (  0 ms)
            Local keyboards     16   (160 ms) - the
default
            BBS, Hosts, etc     32   (320 ms)
            File Transfers      48   (480 ms)

There are two parameters in the PAKET.CFG file specifying the DWAIT
settings you want to use for binary File Transfers (48 recommended) and
for normal operation when the File Transfer is completed (16 recommended).
******************************************************************************
@Echo         ON|OFF    ON      Echo typed characters to screen.
Parameters:
     ON  - Characters received from paKet are echoed by the DSP-12.
     OFF - Characters are not echoed.

When using paKet you should set ECHO OFF.

paKet will display the characters you type in a different colour or
intensity to help you distinguish your transmissions from the data
received.

If you see two copies of everything you type, you should set ECHO OFF.

Local echoing is disabled in transparent mode.

This setting will track the main setting in GCE.
******************************************************************************
@EScape       ON|OFF    OFF     Display character for <ESCAPE>.
Parameters:
     ON  - The ESC ($1B) character is output as "$" ($24).
     OFF - The ESC character is output unchanged.

The translation is disabled in transparent mode.
Some terminals interpret the ESC character as a special command prefix
and may alter their displays depending on the character following the
ESC. Setting ESCAPE ON can protect against such alterations.
See also MFILTER for general character stripping rather than translation.
******************************************************************************
@Flow         ON|OFF    ON      Inhibit output from DSP-12 while typing.
Parameters:
     ON  - Type-in flow control is active.
     OFF - Type-in flow control is disabled.

Setting FLOW ON will keep incoming data from interfering with keyboard
entry and make the screen easier to read.

Type-in flow control is designed to avoid confusing displays where the DSP-12
can send any received data to the display while you are typing something.
It looks like:
       TYPED COMincomMANDing data
With FLOW ON the DSP-12 will hold its data if you have started typing and
will send it when the line is complete.

If you set FLOW OFF, the DSP-12 will continue to send any data to paKet, but
paKet has its own flow control and will allow incoming data to build up in
the buffer until you complete the current line. This may suit you as
paKet's input buffer is larger than the DSP-12's buffer (paKet's buffer is
about 32KB) so there is less chance of filling the buffer and losing data.
******************************************************************************
@FRack        1-15      3       Time in secs to wait for ACK.
Parameters:
      n = 1 to 15 specifying the time the DSP-12 will wait for an ACK
          before retrying that frame.

If the path includes digipeaters the time is adjusted to allow for the
extra delays. An extra random time is added to avoid collisions.
******************************************************************************
@FUlldup      ON|OFF    OFF     Select simplex or duplex mode.
Parameters:
      ON  - Full Duplex mode is enabled
      OFF - Full Duplex mode is disabled

When FULLDUP is OFF the DSP-12 uses the DCD signal from the modem to avoid
collisions and acknowledges multiple packets with a single transmission.

When ON the DSP-12 acknowledges each packet individually.

It should not be used unless a full duplex (split frequency or crossband)
link is implemented.  This parameter defaults to ON in FO-20, PACSAT and
KO-22 Modes.
******************************************************************************
@HEaderln     ON|OFF    OFF     Header and text on separate/same line.
Parameters:
      ON  - The header is displayed on a separate line.
      OFF - The header and text appear on the same line.

This is for monitored packets.

When HEADERLN is ON all monitored packets have the callsigns etc. on one
line and the text is printed on the next line.

paKet does not care which way this is set but if you prefer to have MSTAMP
and/or MRPT on, the header part of the monitored text can be quite long.
In this case it is suggested you set HEADERLN ON to make the data easier
to read.
******************************************************************************
@HId          ON|OFF    OFF     Enable/disable ID every 9 mins.
Parameters:
     ON  - Enables HDLC identification by a digipeating DSP-12.
     OFF - Disables identification.

The ident is yourcall with "/R" added and is output every 9.5 min. and
addressed to the UNPROTO address.

If a DSP-12 is used as a dedicated packet digipeater this should be ON
and CONOK OFF.
******************************************************************************
@Id           none              Force an ID packet.
Parameters:
      None

An identification packet is sent only if your digipeater has transmitted
since the last automatic identification.

HID must be ON for this packet to be sent.
******************************************************************************
@KIll         n         none    Kill a Mailbox message number.

Delete or Kill message number n in the Mailbox message storage area.
******************************************************************************
@KISs         ON|OFF    OFF     Select KISS mode for TCP-IP.
Parameters:
     ON  - Put the DSP-12 in KISS mode.
     OFF - The DSP-12 stays in normal AX25 mode.

Either operation of this switch must be followed by a RESTART. In the
ON condition the computer must be running the appropriate software.

KISS mode provides a simple protocol for use  with a host computer system.
It bypasses most of the controls in the DSP-12 and allows the host
computer to control the HDLC frames. It is up to the host computer to take
care of the protocol details such as AX25 or whatever protocol is desired.

In this case the "host computer" is paKet and paKet does NOT currently
support KISS Mode, so set this OFF.
******************************************************************************
@LCAlls       Call 1-8  blank   List of calls to allow (Budlist).

A list of up to 8 calls with or without substation numbers to be
accepted or rejected according to how BUDLIST is set if MONITOR is on.
To clear the list type LCALLS BLANK.
******************************************************************************
@LCok         ON|OFF    ON      Lower to upper case conversion.
Parameters:
     ON  - The DSP-12 will send all characters directly to the computer.
     OFF - The DSP-12 will translate all lower case characters to upper case.

If both operators set LCOK to OFF then what each types in lower case
will appear as such and the other's transmission will appear in upper
case. This translation is disabled in transparent mode.

In paKet this is best set to ON as the outgoing and incoming text is in
different colours.
******************************************************************************
@LFadd        ON|OFF    OFF     Add a LF to each CR sent.
Parameters:
     ON  - A LF character is added to CR on outgoing packets.
     OFF - No LF is added.

If a station reports your transmissions overprinting on one line, this
could be set ON temporarily, but it would be better if the other station
could set AUTOLF ON.
******************************************************************************
@LFIgnore     ON|OFF    OFF     Filter out LF characters.
Parameters:
     ON  - LF characters are ignored in Command and Converse modes.
     OFF - LF characters are acted upon in Command and Converse mode.

LFIGNORE is useful if the other station has left LFADD ON and causes
double spacing on your screen.
******************************************************************************
@LIst         none              List the 20 most recent messages in Mailbox.

An immediate command to list the 20 most recent messages held in the
Mailbox storage area in the TNC even if the computer has been switched off.
******************************************************************************
@Mailbox      ON|OFF    OFF     Set personal message system on/off.
Parameters:
     ON  - Set personal message system ON and store messages.
     OFF - Set personal message system OFF.

When on the Mailbox feature is enabled.  Remote stations connecting to the
DSP-12 are attached to the mailbox handler.  The local operator has access
to the normal command interface, and can himself access the mailbox by using
the SYSOP command.  All monitoring is disabled when the mailbox is ON.
******************************************************************************
@MAll         ON|OFF    ON      Monitor connected and unproto frames.
Parameters:
     ON  - Monitors all packet frames.
     OFF - I-frames are not monitored.

When OFF I-frames are not displayed in monitor mode.  This parameter is
overridden by the MCOM parameter.
******************************************************************************
@MAXframe     1-7       4       Number of outstanding frames allowed.
Parameters:
      'n' - 1 to 7. This specifies the maximum number of packets that may
            be outstanding (unacknowledged) at any one time.

MAXFRAME also specifies the maximum number of contiguous packets which can
be sent during a transmission.

If throughput is low because of heavy traffic or poor propagation, reduce
MAXFRAME to 2 or 3.

If you are using HF, reduce MAXFRAME to 1.

A relationship between this and PACLEN can improve the efficiency of file
transfers, allowing long bursts on a good link.
******************************************************************************
@MBEAcon      ON|OFF    OFF     Generates "Mail for:...." Beacon.

When this parameter is set ON, the DSP-12 Mailbox will scan the mail queue
and replace (permanantly) the beacon text data (BTEXT) with "Mail for: "
and the callsigns of the users for whom the DSP-12 finds pending mail.
******************************************************************************
@MCOM         ON|OFF    ON      Monitor only data or all frames.

This command enables monitoring of supervisory frames when MONITOR is
ON.

All control fields are decoded so that possible faults in the link can
be detected. See the protocol section of your manual for more information.
As with other monitor commands the stations monitored are determined by
BUDLIST and LCALLS.
******************************************************************************
@MCon         ON|OFF    OFF     Monitor other frames while connected.
Parameters:
     ON  - Monitor mode remains active when DSP-12 is in connected state.
     OFF - Monitor mode is disabled while connected.

Enables monitoring of other conversations while your DSP-12 is connected to
another station. Even number round table conferences can be had using
this command. If set to OFF all other activity on the channel is ignored
while you are connected to a station.
******************************************************************************
@MData        ON|OFF    ON      Monitor Data area of frames.

When ON in monitor mode the data areas of monitored I and UI frames are
displayed.  When OFF, only the address and protocol information from
monitored I and UI frames is displayed.
******************************************************************************
@MFilter      0-$7F     blank   Up to 4 characters purged from data.

Specifying up to 4 characters delimited by commas which can be filtered
out of incoming packets.

To clear the list use MFILTER 00.

Useful if you are using a dumb terminal which interprets control
characters as commands.
******************************************************************************
@MODon        ON|OFF    OFF     Generate Audio Carrier at all times.

When this parameter is set OFF, the DSP-12 will not generate an audio tone
carrier unless the PTT output is active.  When set ON, the DSP-12 will
generate an output audio carrier at all times.  This parameter should be set
ON in the KO-22 mode.

NOTE: This parameter is only implemented when the mode is started from GCE or
      on a RESTART command.  After changing this parameter, do a RESTART to
      get the change implemented correctly.
******************************************************************************
@MHClear      none              Clear the calls heard list.

MHCLEAR is an immediate command to clear the MHEARD list if you want to
monitor channel activity over a specific period of time.
******************************************************************************
@MHeard       none              Display calls heard with date/time.

An immediate command to display the list of calls heard since last time
the buffer was cleared (MHCLEAR or RESTART commands, or power-off).

You can either enter this command at the cmd: prompt or you can
select Alt-H in paKet to generate the command for you.

The maximum number of stations monitored in the list is 16 so that only
the last 16 are displayed.  This list is stored in bbRAM, so is a record
for all modes.
******************************************************************************
@Monitor      ON|OFF    ON      Monitor mode on.

Monitoring of packet activity is enabled or disabled.

MALL, BUDLIST and LCALLS determine which packets are monitored.
See also MRPT, MCOM, MCon, MYCOM, MData and MSTAMP.

MCon allows monitoring when connected.
******************************************************************************
@MRpt         ON|OFF    ON      Display digipeater path.
Parameters:
     ON  - Shows connected station identifiers and digipeating path.
     OFF - Shows only originator and destination calls.

The MRPT command determines whether monitored packets are displayed with
the digipeat path in the header.

Digipeating stations are shown with an asterisk (*).
******************************************************************************
@MStamp       ON|OFF    OFF     Select time stamping of frames monitored.
Parameters:
      ON  - Time stamp on monitored frames.
      OFF - No time stamp on monitored frames.

Enables time stamping of monitored packets if date and time are set.

You might like to set HEADERLN ON if you are using time stamping because
of the additional characters in the header.
******************************************************************************
@MYAlias      call[-n]  blank   Alternate station identifier.
Parameters:
      call - This is an alternate call sign for use as a digipeater only.

You must still specify your call sign in the MYCALL command.

Specify an alternate callsign or sub-station ID. Use of this command
permits normal HID with MYCALL, but an alternate call for digipeating.
******************************************************************************
@MYcall       call[-n]  NOCALL  Station callsign.
Parameters:
      'call' - Your call sign. You may also use a substation ID (SSID)
               (0-15) if you wish.

Example:
      MYCALL VK2JJM       This tells the DSP-12 my call sign.

All transmitted packets will include this callsign, and any connect
requests to this callsign can now be accepted.
******************************************************************************
@MYCOM        ON|OFF    OFF     Displays frames sent to DSP-12 twice.

When ON and monitoring is enabled, frames sent from another node to this node,
in addition to being processed as a part of a connection, are also displayed
as monitored frames.

This feature is useful in debugging, but would not be useful in normal
operation.
******************************************************************************
@NEwmode      ON|OFF    ON      Change modes on Connection.
Parameters:
     ON  - Switch to data transfer with connect command - CMD: on disconnect.
     OFF - Switch to data transfer on connect, but not to CMD: on disconnect.

If ON the DSP-12 will switch to whatever CONMODE is set when the
connection is started without waiting for the connection to be
established. If the connection is terminated, or if the request
fails, the DSP-12 will revert to Command mode.

If OFF, the DSP-12 will remain in Command Mode until the connection is
established. Then it will switch to the mode specified in CONMODE.
The DSP-12 remains in that mode when the connection is terminated.
******************************************************************************
@NOmode       ON|OFF    OFF     Allow/disallow explicit mode change only.
Parameters:
      ON  - The NEWMODE function is ignored. The only way to change modes
            is to type K (or CONV), TRANS, or <Ctrl-C>.
      OFF - The DSP-12 will switch in accordance with the setting of NEWMODE.
******************************************************************************
@Paclen       0-255     128     Number of Bytes in a data frame.
Parameters:
     'n' - 0 to 255 specifies the maximum size of the data portion of a
           packet.
      0  - this is equivalent to a maximum packet size of 256.

In normal CONVERSE mode, a packet will be sent when you press <CR>.

If you have set Single Line Mode in the Type Ahead window (via the F4
key) paKet will generate a <CR> at the end of each full line and
cause the DSP-12 to send a packet at the end of that line.

However a packet is automatically sent by the DSP-12 when PACLEN
characters have been received from the paKet program, so the maximum
size of any packet is determined by PACLEN. If you wish, you could
set PACLEN to (say) 20, and the DSP-12 would transmit a packet after 20
characters are received from the program.  This might be appropriate
for an HF link in poor conditions because there would be greater
chance of getting the full packet through without error if it is a
smaller packet. For good links, a larger packet size is better.

For Binary File transfers, paKet will adjust PACLEN automatically.
******************************************************************************
@PACTime      E|A 0-250 A 10    TRANS mode packet send timer (n * 100ms).
Parameters:
      'n'   - 0 to 250 specifies 100ms intervals
      Every - Packets are sent EVERY n * 100 ms.
      After - Packets are sent AFTER n * 100 ms from last entry at keyboard.

Example:
      PACT A 25       Send a packet 2.5 seconds after the last character
                      was received from paKet.
      PACT E 50       Send a packet every 5 seconds even if data is still
                      being received from paKet.

This parameter is always used in Transparent mode and is used in Converse
mode if CPACTIME is ON. If 'n' is 0, the next packet is sent without any
wait time, but in no case will a zero length packet be sent. The timer
only starts when the first character is received.
******************************************************************************
@PASSAll      ON|OFF    OFF     Accept only valid CRC frames or all.
Parameters:
     ON  - The DSP-12 will accept packets with invalid CRC's.
     OFF - The DSP-12 will only accept packets with valid CRC's.

This would allow some monitoring of data even on a noisy channel, although
paKet would then display all the invalid "garbage" received by the DSP-12.

Normally you would have PASSALL OFF to ensure an error free display.
******************************************************************************
@POOL         Immediate Cmd     Display available memory elements.

This command shows how many memory elements are currently available to the
dynamic memory manager and how many were available when the memory pool was
created.  It also shows some statistics from the AX.25 protocol handler.

NOTE: In down-loaded versions of software this command will cause the
      debugger to be invoked; type "G" and press return to continue normal
      operations.
******************************************************************************
@Quit         Immediate Cmd     Exit to Main Menu.

This command causes the DSP-12 to exit packet-mode processing and return to
the GCE main menu.  When provided with a letter operand, the QUIT command
will cause the DSP-12 to exit the current operating mode, and bypass the GCE
menu to the new specified mode.
******************************************************************************
@RADIODN      0-255     none    Generate n step-down pulses.

This command causes the DSP-12 to generate (n) number of step-down output
pulses.  The operand n defaults to 1 and has a maximum value of 255.
These operands are accumulated into a signed accumulator so that multiple
commands "net out" to the correct number of steps in the correct direction.
******************************************************************************
@RADIOUP      0-255     none    Generate n step-up pulses.

This command causes the DSP-12 to generate (n) number of step-up output
pulses.  The operand n defaults to 1 and has a maximum value of 255.
These operands are accumulated into a signed accumulator so that multiple
commands "net out" to the correct number of steps in the correct direction.
******************************************************************************
@Read         n         none    Read n message from Mailbox storage.

An immediate command to read back message number n from the Personal
Message System storage in the DSP-12. The DSP-12 will indicate the presence
of an active message by blinking the STA led.
******************************************************************************
@RESET        Immediate Cmd     Reset the DSP-12 to default parameters.
Parameters:
      None



                     WARNING   WARNING    WARNING





RESET will reinitialise the DSP-12 to its default ROM parameters.

You will lose all your personalised settings and monitor lists if you type
this command.

This command acts like GCE's 99+ command in that it defaults ALL of the
DSP-12 parameters (not just the parameters for this mode).  After clearing
the non-volatile parameters, GCE will force the user to ABR the terminal
and restore all of the DSP-12's parameters.

If you wish to reinitialise the DSP-12, but retain your own parameters,
use RESTART.
******************************************************************************
@RESptime 'n' 0-250     10      Delay for sending an ACK (n * 100ms).
Parameters:
      'n' - 0 to 250 specifies the number of 100ms intervals for delay.

This command sets the minimum delay before an acknowledgement packet is
sent. This will be in addition to any delay set by DWAIT.

When file transfers are being done, occasionally a collision may occur
with an ACK frame. If RESPTIME is set to say 10 then this will be avoided
and an increase in the throughput will result.

For paKet, leave RESP at its default of 10.
******************************************************************************
@RESTART      none              Reset the DSP-12 with user parameters.
Parameters:
     none


RESTART is an immediate command to reset the DSP-12 but retaining the user
supplied parameters stored in Battery-Backed RAM.

This has the same effect as switching the DSP-12's power off then on.

If a complete reinitialisation is required then use RESET, but that will
require you to reenter all your parameters including your MYCALL, etc.
******************************************************************************
@REtry        0-15      10      Number of retries before disconnect.
Parameters:
      'n' - 0 to 15 specifies the maximum number of packet retries before
            disconnecting.

A number of 0 specifies an infinite number of retries.

The time between retries is determined by the FRACK parameter.
******************************************************************************
@RXPort     HF|VHF|UHF  VHF     Specify Receive Port.

This parameter specifies which radio port the DSP-12 modem uses as its input
source, and to which port it sends mic-click tuning step outputs to.
******************************************************************************
@SEND         call      none    Enter a message to call in Mailbox.

Send a personal message to callsign for later reading by that station
in the personal message service storage area. This is only possible
if the other station has Mailbox available and has set it ON with a Mailbox
call the same as the one you are connected to.
******************************************************************************
@SEndpac 'n'  0-$7f     $0D(CR) Character to force packet to be sent.
Parameters:
      'n' - 0 to 127 specifies an ASCII character code to be used as the
            <SENDPAC> character.

The default character is <CR> which means a packet will be sent when you
press the <CR> key.

You might like to set this to some value you would not normally use if you
decide to set CPACTIME ON in order to send packets at regular intervals
rather than at the end of a line.

Please leave this set to the default value (<CR>).

However, if paKet's Word Wrap option is ON (which is the default, but
refer to the F4 key) it will generate a <CR> at the end of a full line to
save you having to watch for the end of a line. So, if you change this
SENDPAC character to something else, that Word Wrap feature will insert
the <CR> into the data but will not cause the packet to be sent at the end
of the line as expected, but will result in the receiving station having
formatted line lengths.
******************************************************************************
@SLotmask 'n' 0-n       15      Specify largest random Number.
Parameters:
      'n' - 0 to n specifies generation for PERSIST CSMA operation.

This parameter would normally not be used unless you have other stations
in your area using the PERSIST/DEADtime method.

******************************************************************************
@STATus       none              Query DSP-12 about Conn and Ack status.

An immediate command to query the status of connection and acknowledge
frames in the DSP-12. 'C' as in CONNECT will also give the status of the
connection.
******************************************************************************
@STeps     USB|LSB|OFF  OFF     Activate Mic-click outputs.
Parameters:
     USB - Enables step-up if received tone is low (and visa-versa).
     LSB - Enables step-down if received tone is low (and visa-versa).
     OFF - Normal packet operation.

The DSP-12 is capable of generating mic-click step outputs which are useful
for keeping a receiver in proper tune during the low-earth orbit passes of
satellites transmitting BPSK signals.
******************************************************************************
@SYsop        Immediate Cmd     Enter DSP-12 Mailbox.

This command is used by the operator to enter the DSP-12's mailbox.  This
command will be rejected if the MAILBOX parameter is OFF.
******************************************************************************
@Trans        none              Enter transparent mode from CMD:

An immediate command to put the DSP-12 in transparent mode to allow
transmission of binary data in full 8 bit format.

Transparent mode is used by paKet for its Binary File transfers but you do
not need to concern yourself with this because paKet makes the switch
automatically, returning to Converse mode when the file transfer is
completed.
******************************************************************************
@TRFlow       ON|OFF    OFF     Disable terminal trans mode flow control.
Parameters:
     ON  - Enables software flow control in transparent mode.
     OFF - Disables software flow control in transparent mode.

You should set this parameter OFF.

It is used for software handshaking when receiving a file in
Transparent mode. The paKet program will look after this for you
automatically.

See also TXFLOW, XFLOW.
******************************************************************************
@TXdelay 'n'  0-120     30      Keying delay for transmitter (n * 10ms).
Parameters:
      'n' - 0 to 120 specifies the number of 10ms intervals to wait before
            commencing the transmission.

The DSP-12 will wait for this time after keying the PTT line before sending
any data.

This is to allow time for relay switching and settling and in synthesised
rigs for the PLL to lock.
******************************************************************************
@TXFlow       ON|OFF    OFF     Disable DSP-12 trans flow control.
Parameters:
     ON  - Enables software flow control when in transparent mode.
     OFF - Disables software flow control when in transparent mode.

You should set this parameter OFF.

It is used for software handshaking when sending a file in Transparent mode.
The paKet program will look after this for you automatically.

See also TRFLOW, XFLOW, XON, XOFF.
******************************************************************************
@TXPort     HF|VHF|UHF  VHF     Specify Transmit Port.

This parameter specifies which radio port the DSP-12 modem uses as its output
source, and to which port it sends mic-click tuning step outputs to.
******************************************************************************
@TXUIfram     ON|OFF    ON      Enable/disable UI frames in converse.
Parameters:
     ON  - Enable sending UI frames in converse mode.
     OFF - Disable UI frames in converse mode.

******************************************************************************
@Unproto      call      CQ      Address and path for beacons.
Parameters:
      'call' - The call sign to be placed in the TO address field for any
               unconnected packets, such as Beacons.

The 'call' address may include up to 8 digipeaters as well. See the
CONNECT command for details on how to specify digipeaters.

The UNPROTOCOL parameters are not stored by lettered mode, but rather are
stored in one area common to all packet modes in the DSP-12.
******************************************************************************
@Xflow        ON|OFF    ON      XON/XOFF flow control or hardware.
Parameters:
     ON  - XON/XOFF Software flow control is enabled.
     OFF - XON/XOFF treated as data - no flow control is enabled.

Hardware flow control is the preferred method but it seems  the current
release of DSP-12 firmware does not fully support hardware flow control.

See also TRFLOW, TXFLOW, START, STOP, XON, XOFF.
******************************************************************************
@XMitok       ON|OFF    ON      Allow transmitter to be keyed.
Parameters:
      ON  - The transmitter's PTT line may be switched on.
      OFF - The transmitter's PTT line cannot be activated.

This feature may be most useful for testing as all other functions work
normally, including sending and receiving of data. The only difference is
that when data is sent to the radio, it is not actually transmitted
because the PTT line is not switched on.

It is also useful if you want to leave the system running while you are
absent, but do not want any unattended transmissions.
******************************************************************************
@XOff 'n'     0-$7F     $13(^S) Character to stop data flow to the DSP-12
Parameters:
      'n' - 0 to 127 specifies an ASCII character code to be used as the
            <XOFF> character.

<XOFF> is the ASCII character to stop data flow from paKet to the DSP-12.


                       PLEASE DON'T CHANGE THIS

Although XOFF might be set to 0 temporarily during binary file
transfers with Software handshaking, the paKet program expects XOFF to
be <Ctrl/S> and will not function correctly if you change it.
******************************************************************************
@XON 'n'      0-$7F     $11(^Q) Character to start data flow to the DSP-12
Parameters:
      'n' - 0 to 127 specifies an ASCII character code to be used as the
            <XON> character.

<XON> is the ASCII character to restart data flow from paKet to the DSP-12
after an <XOFF>.

                       PLEASE DON'T CHANGE THIS

Although XON might be set to 0 temporarily during binary file
transfers with Software handshaking, the paKet program expects XON to
be <Ctrl/Q> and will not function correctly if you change it.
